API 文档 ​

下班工具箱的后端基于 FastAPI 构建，提供本地 HTTP 接口供客户端调用。

基础信息 ​

• 服务地址：默认 http://127.0.0.1:7410（可在设置中修改）
• 接口前缀：所有业务接口均以 /api/v1/ 开头
• 数据格式：请求/响应均为 JSON（文件上传除外）

认证方式 ​

后端通过 EDUASSIST_TOKEN 环境变量开启 Bearer Token 认证：

• 所有接口（除 /health 与 OPTIONS 预检请求）都要求请求头携带 Authorization: Bearer <token>。
• 若未设置该环境变量（即 token 为空），则进入开发者模式，不做鉴权校验。
• 未携带或携带错误的 token 时，返回 401，响应体为 {"detail": "Unauthorized"}。

健康检查 ​

• GET /health：探测后端是否在线，返回 {"status": "ok"}。

接口模块 ​

错误响应 ​

业务校验失败时返回对应 HTTP 状态码，响应体结构统一为：

{ "detail": "错误信息" }

常见的错误码：